Using Printing-Related Collection Objects(IM:XP)

Inside Macintosh: QuickDraw GX Printing /: Chapter 3 - Page Formatting and Dialog Box Customization

Using Printing-Related Collection Objects
Your application can use collection objects to store information associated with a particular document. To access collection objects used by QuickDraw GX printing features, you use functions provided by QuickDraw GX. You manipulate the pieces of information in collection objects using Collection Manager functions. The Collection Manager is described in Inside Macintosh: Environment and Utilities.
QuickDraw GX allows you to access a collection object associated with a job object, format object, or paper-type object. If you want to store or access printing-related information associated with a document in the job collection, you use the GXGetJobCollection function to access this collection object. If you want to store or access formatting information in the format collection, you use the GXGetFormatCollection function. If you want to store or access paper-type information in the paper-type collection, you use the GXGetPaperTypeCollection function.
You then specify the collection item in a call to GetCollectionItem to retrieve the specific data from a collection. The collection item corresponds to the data you wish to retrieve. For example, the gxCopiesTag collection item specifies access to data in the gxCopiesInfo data structure:
enum {gxCopiesTag = 'copy'};

struct gxCopiesInfo{
   long copies;
};
Note
The collection tags, collection item tags, and structures for collection objects are defined in the section "Constants and Data Types" beginning on page 3-133. For complete information about using collections, see the Collection Manager chapter of Inside Macintosh: QuickDraw GX Environment and Utilities.

Subtopics

Accessing Data From a Collection Object

Using a Collection to Implement the Print One Copy Menu Item

Replacing Items in Collections

Specifying Page Ranges in the Job Collection